home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 October / Macworld (1998-10).dmg / Shareware World / Utilities / Data & Time Management / Pardeikes Welcome Plugin 2.0 / Version History < prev    next >
Text File  |  1998-07-24  |  31KB  |  883 lines
  1. Pardeikes Welcome Plugin 2.0
  2. ======================
  3.  
  4. Version History
  5.  
  6. ____________________________________________________________
  7.  
  8. What's new in 2.0:
  9.  
  10. I just decided to call it 2.0 instead of 1.6 to reflect all these
  11. new changes.
  12.  
  13. Bug Fixes & Improvments:
  14.  
  15. - Removed a bug in the rule converting code.
  16.  
  17. - Added a monitoring call: http://www.foo.com/monitor.welcome
  18.  
  19. - Minor changes to the getRule and setRule calls.
  20.  
  21. ____________________________________________________________
  22.  
  23. What's new in 1.6b23:
  24.  
  25. Since I have rewritten the internal format for all
  26. configuration files, I need to test again. So many things
  27. have changed, hopefully you understand that I cannot
  28. rely on beta 22 testing (which was really good).
  29.  
  30. Here are the new features:
  31.  
  32. • NEW LOG FORMATS!!
  33. Rules and Hosts are now saved as tab-text files. You can
  34. (and should) use the supplied Filemaker Pro 4.0 database
  35. templates to import/export data from the files "Welcome Hosts"
  36. and "Welcome Rules". All converting is done the first time you
  37. start Welcome, so you don't have to do it yourself. Please make
  38. backups before starting Welcome.
  39.  
  40. • New external log saving!
  41. In any rule, you can now define a path to a log file. Also,
  42. you define some text that is added to that file. Use the two
  43. new fields below the "Mode" field: "Append to file:" and
  44. "Append this text:" for that.
  45. The path uses "/" to separate folders and you can use wildcard
  46. results in this field to make it a dynamic path. Any non-existant
  47. folders will be created by Welcome. It is a root relative path
  48. and should start with a "/" (like the "Path:" field).
  49. The appended text can also use wildcards (only this makes
  50. sense at all) and here is a list of additional strings you can
  51. use in this field as well:
  52.  
  53. \t - tab
  54. \r - return
  55. \n - newline
  56. \#nnn - ascii character nnn (decimal)
  57. \d - macintosh formatted date (can be imported to filem.)
  58. \h - macintosh formatted time (can be imported to filem.)
  59. \1 - seconds (two digits)
  60. \2 - minutes (two digits)
  61. \3 - hours (two digits)
  62. \4 - day (two digits)
  63. \5 - day of week, and sunday = 0 (two digits)
  64. \6 - month (two digits)
  65. \7 - year (two digits)
  66.  
  67. Example: Something that will log any referer to an image on
  68. your site (only if the referrer is not yourself):
  69.  
  70. Name:             Log Graphic-Referers
  71. Path:             *.{gif jpg}
  72. Referrer:         http://www.yourserver.com*
  73. "Referer" :       *     <- use the custom field
  74. Condition:        <P0>&<!R0>&<C0>
  75. Append to file:   /<P2>-grabbers.txt
  76. Append this text: \d\t\h\t<P0>\t<C1>\r
  77.  
  78. • Extended "Jump to:" field
  79. You can now use "=n" to jump to rule n and "+d" to jump
  80. forward (0 is current rule, 1 is next rule...) and "-d" to
  81. jump backwards (0 is current rule, -1 is previous rule...)
  82. Of course, "stop" and any rule name will continue to work
  83. in this field.
  84.  
  85. • Folder creation
  86. Either the "External-Referrer Log" or the "Error Log"
  87. will now create any subfolders if they are not present.
  88.  
  89. ____________________________________________________________
  90.  
  91. What's new in 1.6b22:
  92.  
  93. Bug Fixes & Improvments:
  94. Version 1.6b21 was actually not the real last beta 21.
  95. It does not include the fix for the corrupted count file.
  96. It also does not fix the custom color bug on the gif
  97. statistics. All these potential changes are present in
  98. 1.6 beta 22.
  99.  
  100. • Fixed a bug, where the Referrer field at the test
  101. page where not working.
  102.  
  103. • You can now have the six wildcard fields to be case-
  104. sensitive. Just check the checkboxes, that are located
  105. below those 6 fields.
  106.  
  107. ____________________________________________________________
  108.  
  109. What's new in 1.6b21:
  110.  
  111. Bug Fixes & Improvments:
  112. • Fixed a crash when clicking on "Clear Hit Counter"
  113. while it was not enabled at all.
  114.  
  115. • Probably fixed the bug with corrupted Count File.
  116. Welcome now opens/closes the file every time it needs
  117. to update information. If an error occurs, it will just
  118. not update the info, but simply continues...
  119. If Welcome is starting with a corrupted Count File
  120. anyway, it will just stop updating it until you remove
  121. the corrupted file. In that case, it will create a new
  122. one without a server restart.
  123.  
  124. • Fixed a color bug, where colors got mixed up on the
  125. graphical statistic when someone used custom colors
  126. on "Overall" or with a unknown host name.
  127.  
  128. • Now you can send 301 and 302 redirect messages.
  129. At the rule page, there is a "Redirect temporary" and
  130. a "Redirect permanent" radio button.
  131.  
  132. • On public demand, I have reversed the order of the
  133. counting statistics. Older dates are at the end of the
  134. list.
  135.  
  136. • You can now use
  137. <!--#exec piservice="WELCOME_#" param="cmds"-->
  138. to insert specific values out of every counting stats into
  139. a SSI page.
  140. "cmds" is of format "virtualhostname/s/i/k"
  141. where s is either "0,-1,...,-7" or "d" or "m" and i is the
  142. index of the table line (i.e. i = 0 means first
  143. line in table) and k is either "h","b","e" or "u"
  144. (Hits,Bytes,Errors,Users)
  145. Example: param="www.test.de/m/8/b" will use the
  146. 9th line out of the monthly table of "www.test.de" to
  147. get the bytes transfered.
  148.  
  149. Still to do:
  150. Make wildcard matching case-sensitive on demand.
  151.  
  152. ____________________________________________________________
  153.  
  154. What's new in 1.6b20:
  155.  
  156. Bug Fixes & Improvments:
  157. • New memory scheme that will work better with many
  158. hosts (previous more than about 70 hosts and enabling
  159. stats and hit counters will give you trouble)
  160.  
  161. • If you set an ALLOW filter for the pi_admin realm,
  162. Welcome was not accessable from that IP number.
  163. Now, if you set e.g. ALLOW 128.23.5.88. for the
  164. pi_admin realm, you can access pi_admin.welcome
  165. from the computer with ip=128.23.5.88
  166. Beta 19 already did this, but I forgot the ending dot
  167. in the IP address. For security reasons, Welcome 
  168. will only detect FULL ip allows and no ranges of IPs...
  169.  
  170. • PRIV log entries are not counted as ERR anymore
  171.  
  172. • If you have more hosts defined in the "Welcome Data"
  173. file than you have set as a maximun at the prefs page,
  174. Welcome now handles this correctly (previous, the last
  175. possible host was corrupted...)
  176.  
  177. • You can now use Rule Result: MY_REALM/folder/aPage
  178. to display a password dialog for MY_REALM and if the
  179. user clicks cancel, Welcome will send /folder/aPage
  180. (relative to the server root). So you are now able to
  181. have your own "Access denied" pages. BTW: you can
  182. use wildcard references to create that path. Example:
  183. Rule Result: MY_REALM<P1>/deny.txt
  184.  
  185. ____________________________________________________________
  186.  
  187. What's new in 1.6b19:
  188.  
  189. Bug Fixes:
  190. • Welcome is now fully compatible with NITRO ULTRA.
  191.  
  192. • Wildcards are now encoded correctly if you use
  193. pi.admin.welcome&getrule=n
  194.  
  195. • Welcome was adding ASCII 0 characters to the referer
  196. and error logs. Thus you were not able to read the full
  197. file. This is fixed now. Each line ends in a simple ASCII 13
  198. and if your browser displays the log in one big line without
  199. line breaks, you should use a different file name or file
  200. suffix for the logs. Beta 17 was ending each line with
  201. ASCII 13 - ASCII 10 but to be more compatible with
  202. databases, beta 18 removed the ASCII 10 but I forgot
  203. to reduce the number of written bytes, thus a ASCII 0
  204. was added to the end of each line.
  205.  
  206. • Now Welcome does not encode/decode + in the search args
  207. or path args anymore. Thus e.g. ..../?name=ab+cd&age=7
  208. is handled fine. However, + in the path portion will be
  209. decoded to spaces, because some users have file names
  210. that contain spaces (e.g. www.host.com/ab+cd/foo.html
  211. and a folder called "ab cd").
  212.  
  213. • "Hide subfolders if possible" now removes the subfolder
  214. with a redirect ONLY if the current request is not a POST
  215. request. Prior, the post arguments were not send again when
  216. the browser was receiving a redirect - thus they were lost.
  217.  
  218. • If you have Allow/Deny addresses set for the pi_admin
  219. realm, Welcome was complaining about a missing realm.
  220. Now Welcome accepts calls to pi_admin realm that are
  221. not restricted by uses of allow's to that realm. For security
  222. reasons, you can only define allow's for full IP numbers!!
  223. (ALLOW * or ALLOW www.somehost.com or ALLOW 195.*
  224. will NOT WORK, only ALLOW n.n.n.n with n=0...255)
  225.  
  226. ____________________________________________________________
  227.  
  228. What's new in 1.6b18:
  229.  
  230. Bug Fix:
  231. • Several small cosmetic bug fixes. 
  232.  
  233. New & Improved:
  234. • Welcome uses the information from multihoming software
  235. like Starnines VH plugin to set the correct Host: entry and
  236. route hits to its own host set-up.
  237.  
  238. • Some pages (mostly the prefs page) were cleaned up and
  239. some comments were added.
  240.  
  241. • The 3 beeps per minutes were removed. Most users were
  242. annoyed by this, however I hope that I can trust people to
  243. really pay for my product and support. Remember: a pizza
  244. may cost 20 bucks and does nothing for your server ...  :-)
  245.  
  246. • A dialog, that works with every browser, was added to
  247. inform unregistered users about the 7-days-in-sequence
  248. testing restriction.
  249.  
  250. • Statistics were renamed to avoid confusion. The statistics
  251. now split into two seperate features:
  252. a) Activity Graph and b) Hit Counters
  253.  
  254. • You can use Welcome to create realtime statistics even if
  255. you don't use Welcome for multihoming or virtual hosting.
  256. For this, a new checkbox: (x) Ignore not configured hosts
  257. was added to the prefs page. It will allow you to only use
  258. the host definition pages in Welcome for defining statistics.
  259. For this to work, do the following:
  260.  
  261. - Check "Ignore not configured hosts" at the prefs page
  262. - Add every host to Welcome that you like to count stats for
  263. - Leave the subfolder for that host  empty!
  264. - Set the index file to "None"
  265. - Se the slash handling to "Never"
  266. - Enable the statistics options: Activity Graph & Hit Counters
  267.  
  268. • The text page that was returned from
  269. /pi_admin.welcome?getrule=n was modified so it contains
  270. the field names and is better readable.
  271.  
  272. ____________________________________________________________
  273.  
  274. What's new in 1.6b16 + 1.6b17:
  275.  
  276. Bug Fix:
  277. • Custom tags got corrupted between calls. After I made
  278. these values local to the current request, this is fixed now.
  279. Beta 17 fixes one small bug left in beta 16.
  280.  
  281. ____________________________________________________________
  282.  
  283. What's new in 1.6b15:
  284.  
  285. Bugs & Fixes
  286. =========
  287.  
  288. Bug Fix:
  289. • Logging of errors and referer now works independand
  290. to counting statistics. Before, both logs were only created
  291. when Counting Stats were enabled. In beta 14, I forget to
  292. tell that the paths for both files are SERVER root relative.
  293.  
  294. • Some users report crashes when switching from older
  295. version to beta 14. This was not reproducable by me, so
  296. please report it if it happens to you too.
  297.  
  298. Changed and New:
  299. • Graphical stats now have only one url -> stats.welcome.
  300. Calling "pi_admin_stats.welcome" was replaced by
  301. "stats.welcome" - Welcome now protects it with the pi_admin
  302. password themself. This was done to reduce the number of calls.
  303.  
  304. • If Welcome is used with AppleShareIP, security is preserved
  305. by defining a custom pi_admin password in Welcome. As ASIP
  306. does not support REALMS, Welcome defines its own protecting
  307. password (for accessing ....pi_admin.welcome....)
  308. For access, you need to create a file called "Welcome Password"
  309. inside the "Welcome-Plugin ƒ" folder. Put a name:password
  310. line into it and Welcome reads it when the server is starting.
  311. Without this file, access to Welcome is denied.
  312.  
  313. • For other servers than AppleShareIP, Welcome checks if
  314. a REALM pi_admin is defined. If not, Welcome cannot be
  315. accessed.
  316.  
  317. • Some users have virtual subfolders like "/myfolder/".
  318. Welcome now correct these entries to "/myfolder" to prevent
  319. double "//" inside the url.
  320.  
  321. ____________________________________________________________
  322.  
  323. What's new in 1.6b14:
  324.  
  325. Beta 14 will last until 30th April. It is the final
  326. beta and if no bugs or major suggestions reach me,
  327. it will become the final 1.6 version.
  328.  
  329. Bugs & Fixes
  330. =========
  331.  
  332. Bug Fix:
  333. • Fixed crashes with 68k WebSTAR 1.3.2 (its not my fault,
  334. WebSTAR 1.3.2 does not handle some parameters correctly)
  335.  
  336. Changed and New:
  337. • There are two new fields at the host page. You can use
  338. them to create log files for
  339. a) external referers (that is, referer is not yourself)
  340. b) errors
  341. If you put root relative paths (like :myfolder:errors.txt)
  342. into it, Welcome will create those files and append any new
  343. data. I have added two FileMaker Pro templates, so you can
  344. easily import those files.
  345. Format of a)
  346. Date<tab>Time<tab>External-Referer<tab>Current-Path<CR><LF>....
  347. Format of b):
  348. Date<tab>Time<tab>Error-Path<tab>Referer<CR><LF>....
  349.  
  350. • The graphical stats now have a correct and meaningful
  351. vertical scale. The units are displayed right next to the
  352. axis. Due to this change, the stats format has changed, so
  353. you will loose your last (graphical) stats if you install
  354. beta 14. Sorry.
  355.  
  356. • The counting stats tables can now have custom header
  357. names. Just use this format:
  358. .../count.welcome?[#,d,m]/[colors]/n1,n2,n3,n4
  359. where
  360. n1 = name instead of "Hits"
  361. n2 = name instead of "Bytes"
  362. n3 = name instead of "Erors"
  363. n4 = name instead of "Users"
  364. Note, that n1...n4 can only be 16 characters max. each.
  365.  
  366. • The test page has one new field where you can put your
  367. custom HTTP header lines. E.g. you can put the following
  368. into it:
  369. Authorization: Basic [putBase64EncodedPasswordhere]
  370. Accept: html/text, */*
  371. Note. You cannot put a real name:password combination
  372. after Authorization, because you are simulating a http
  373. header, you need to encode it. The simplest way to get this
  374. is to use your browser to accees e.g. pi_admin.... and set
  375. the "Verbose Mode" of WebSTAR to "On". Then watch the
  376. log while you enter a password and finally click cancel
  377. or type it in correctly. You should find a encoded string
  378. of your name:password in the log.
  379.  
  380. ____________________________________________________________
  381.  
  382. What's new in 1.6b13:
  383.  
  384. Bugs & Fixes
  385. =========
  386.  
  387. Bug Fix:
  388. • Saving the graphical stats to a temporary file has been
  389. fixed. Before, Welcome could crash if someone had changed
  390. the Welcome Data file so it got out of sync with the temp
  391. file.
  392.  
  393. • Two small bugs were fixed that could cause crashes on
  394. startup and when entering new hosts.
  395.  
  396. • Stats tables are now HTML encoded if necessary.
  397.  
  398. Changed and New:
  399. • Welcome now reloads the external files (the file that
  400. start with #) automatically every minute if they have
  401. been changed. No need to call reload.welcome to update
  402. any changes to those files.
  403.  
  404. • You can now define for each virtual host whether the stats
  405. are counted separate for this host or if they are counted
  406. to the "primary" host. A primary host is the first (from top)
  407. virtual host that has the same subfolder.
  408.  
  409. • There is a new function for the Missing Host path on the
  410. prefs page. If you put "pass" (without "") in the field,
  411. Welcome will simply ignore any not configured virtual
  412. host requests. That is very helpful when using Welcome
  413. for statistics, rules and multiple index files if you are
  414. using another virtual hosting solution (e.g. FireSite, W* 3.0
  415. or ClearlyHome). In this case, you need to leave the virtual
  416. subfolder of every host you define in Welcome empty.
  417.  
  418. ____________________________________________________________
  419.  
  420. What's new in 1.6b12:
  421.  
  422. Bugs & Fixes
  423. =========
  424.  
  425. Bug Fix:
  426. • A bug, with bytes_send > 4 GB not calculated correctly
  427. was fixed. Also bars for those values are now correct.
  428.  
  429. • Welcome now checks the 'vers' resource to determine
  430. if it is installed on WebSTAR 1.3.2 to prevent a crash
  431. if the logging is registered with WebSTAR 1.3.2.
  432.  
  433. Changed:
  434. • Welcome now works with ASIP. To use hit
  435. counting, Welcome needs to be configured in ASIP as a
  436. postprocessor.
  437.  
  438. • Welcome now uses GIF format instead of JPEG. This
  439. will free more memory and makes it compatible with
  440. ASIP. You don't need QuickTime anymore. As a result
  441. of this, the call for graphical stats has changed. It does
  442. not contain the quality flag anymore:
  443. ..../stats.welcome?[host name here]    or
  444. ..../pi_admin_stats.welcome?[host name here]
  445. As a result, the final graphic is only around 2K of size!
  446.  
  447. • You can add your own color layout for either the
  448. graphical stats or the hit counters. Append the following
  449. hex colors to the known calls:
  450. ..../count.welcome?[host name]/[selector]/[colors1]
  451. and
  452. ..../stats.welcome?[host name]/[colors2]  or
  453. ..../pi_admin_stats.welcome?[host name]/[colors2]
  454. Use a sequence of hex colors (000000 - FFFFFF) in
  455. each [color1] and [color2] which are defined as:
  456. [color1] = BBBBBBTTTTTTFFFFFFIIIIIIXXXXXXAAAAAA
  457. and B = Background, T = Title, F = Frame, I = Inside,
  458. X = Text and A = Bars
  459. [color2] = BBBBBBLLLLLL111111222222FFFFFF
  460. and B = Background, L = Labels, 1 = Inside1, 2 = Inside2
  461. and F = Inner frame
  462.  
  463. Examples: (Colors same as built-in colors)
  464.  
  465. ..../stats.welcome?www.abc.com/999999000000CCCCCCFFFFFFFFFFFF
  466. ..../count.welcome?www.abc.com/d/FFFFFF999999CCCCCCFFFFCC000000FF0000
  467.  
  468. • You can now use the counting tables inside SSI. To insert
  469. them into your SSI parsed page, you can use the following
  470. syntax:
  471.  
  472. <!--#exec piservice="WELCOME_STATS"  param="xxxxxx"-->
  473. and replace xxxxxx with the stuff you would write after the ?
  474. in the normal call. To insert the example call from above, you
  475. would write:
  476. <!--#exec piservice="WELCOME_STATS"  param="www.abc.com/d/FFFFFF999999CCCCCCFFFFCC000000FF0000"-->
  477.  
  478. You can place more than one #exec call in the same page to get more
  479. than one table shown.
  480.  
  481.  
  482. Still do to:
  483. • Custom protection for ASIP's PI_ADMIN realm
  484.  
  485. • Allow to disable the "Missing Host page", so users can
  486. use Welcome to count stats with other virtual hosting
  487. plugins or servers. Currently, defining all hosts to
  488. count with a empty subfolder will do too, but only
  489. works if ALL hosts are configured. To prevent errors
  490. for not configured hosts, we need a "disable it" feature.
  491.  
  492. ____________________________________________________________
  493.  
  494. What's new in 1.6b11:
  495.  
  496. Bugs & Fixes
  497. =========
  498.  
  499. New: Welcome now supports logging for QuidProQuo.
  500. However, you will need to configure QPQ for this. Go
  501. to the Pre/Postprocessor setup of QPQ and enter
  502. ".welcome" as a Preprocessor (without the ""). Due
  503. to a bug in QPQ 2.1, Welcome will not count Bytes
  504. and Errors. I am working closly with the developer
  505. of QPQ to make this easier and better for you. He said
  506. he is working on 2.1.1 - which should be fully compatible
  507. with Welcome.
  508.  
  509. New: Welcome now supports WebSTAR 1.3.2 for logging
  510. too. Just go to the Pre/Postprocessor section in the
  511. WebAdmin (misc settings) and set the Postprocessor
  512. to ".welcome" (without the ""). This is necessary because
  513. WebSTAR 1.3.2 does not support the plugins logging role.
  514.  
  515. New: Welcome now counts "user visits". You can define
  516. the time a new visit will occur by going to the prefs page
  517. and entering a value like e.g. 300 secs = 5 minutes. So if
  518. a user hits the site in intervals less then 5 minutes all
  519. hits will not generate new visits.
  520. Attention: Sorry, the count file format has changed. This
  521. means that all your old counts will be set to zero when
  522. using beta 11 for the first time.
  523.  
  524. New: A new setting at the prefs page (at the bottom of the
  525. page) will control how Welcome uses its memory. Set the
  526. max. number of virtual hosts to a value between 1...10000.
  527. Set it low to preserve memory. Also check the "Save memory"
  528. option if you get low memory situations. Welcome will write
  529. most changes directly to disk thus freeing more memory.
  530. However, this can slow down the server access by a few
  531. milliseconds (not much in other words).
  532.  
  533. Changed: Count pages will show bars for all values and they
  534. contain the new "Visits" count. Also the delivery of count
  535. pages has be speeded up. They load faster.
  536.  
  537. Bug Fixes: Several small bugs were fixed. All of them
  538. were too complicated to explain.
  539.  
  540. ____________________________________________________________
  541.  
  542. What's new in 1.6b10:
  543.  
  544. Bugs & Fixes
  545. =========
  546.  
  547. This version of Welcome is primary a bug fix release. It
  548. fixes several internal bugs that are not worth to tell about.
  549.  
  550. Changed: Welcome now saves the hit counts linked to the
  551. host name, not the host subfolder. You should delete the
  552. file "Welcome Counts" before starting this release. All
  553. old hit counts will be ignored.
  554.  
  555. ____________________________________________________________
  556.  
  557. What's new in 1.6b9:
  558.  
  559. Bugs & Fixes
  560. =========
  561.  
  562. Fixed a bug where WIDTH=0 in a gif will crash Netscape 4.0.4
  563. Now Welcome just don't add <IMG SRC=...> if WIDTH is 0.
  564.  
  565. Fixed a bug where counters did not jump to the next day.
  566.  
  567. Fixed a bug, where clearing stats (also at startup) will corrupt
  568. stats, so counting did not continue.
  569.  
  570. Changed the way logging checked the host. Previous Welcome
  571. checked the virtual subfolder. Now Welcome is checking the
  572. Host: entry instead. Virtual hosting will always add it if it
  573. is missing, so no problem for the logging part.
  574.  
  575. Welcome now saves the overall stats periodically (like all
  576. others, but for overall, it was missing).
  577.  
  578. Fixed some other minor and dumb bugs that may crash your
  579. server.
  580.  
  581. Update: Welcome now dispays Bytes, KBytes and MB instead
  582. of the pure bytes values.
  583.  
  584. Changed: To reload all Welcome data (Hosts, Rules,  External
  585. Files), you should now call ..../reload.welcome insteaf of
  586. ..../pi_admin.welcome?reload. This will put the control to
  587. the webmaster. He/She can decide to protect this call with
  588. a realm "reload.welcome" or make it public, so users can
  589. call it to reload all external files.
  590.  
  591. ____________________________________________________________
  592.  
  593. What's new in 1.6b8:
  594.  
  595. Bugs & Fixes
  596. =========
  597.  
  598. Fixed a bug where graphical stats where not saved to the
  599. temp file (maybe because MacOS 8.x).
  600.  
  601. Fixed usage of WSAPI_SendHTTPData (that problem was shown
  602. by Chuck with its Server Fix Plugin). Welcome will not send
  603. data to the client if the connection has dropped. Thanks Chuck!
  604.  
  605. Welcome now checks for the existance of a realm "pi_admin".
  606. This was added for extra security.
  607.  
  608. The number of possible hosts was reduced from 10000 to 2000
  609. to preserve some memory.
  610.  
  611. STILL TO DO: QuidProQuo does not support the Logging Role in
  612. WSAPI. Welcome uses this role to collect hits for hit counting.
  613. You will never see hits counted in QPQ 2.1 - until I found out
  614. how to create a workaround, please be patient...
  615.  
  616. NEW: Do you like real hit statistics? Here they are:
  617. Welcome now counts hits for every hour within the last 8 days;
  618. for every day within the last 64 days and for every month of
  619. the last 24 month. The only thing you need to do, is to enable
  620. hit counting by checking the checkbox at each host page.
  621. Access for stats is:
  622. ..../count.welcome?[domain name]/[selector]
  623. and
  624. [domain name] is either one of the virtual hosts
  625. (e.g. "www.some.com") or the string "OverAll", which gives
  626. you the total hit count and [selector] is either
  627. • 0 = for today
  628. • -1 up to -7 = yesterday, day before, ....
  629. • day = daily counts for the last 64 days
  630. • months = monthly counts for the last 24 month
  631. Examples:
  632. ..../count.welcome?OverAll/0
  633. ..../count.welcome?OverAll/-4
  634. ..../count.welcome?www.aHost.com/days
  635. ..../count.welcome?www.aHost.com/months
  636. It depends on your settings for private/public stats if these
  637. calls will be protected with the hosts name/password or if they
  638. are for public access. The OverAll call is protected by the
  639. pi_admin name/password.
  640. There are two new links to reset hit counters: one at the host
  641. list to reset the overall counting and on each host page to reset
  642. the hosts hits.
  643.  
  644. ____________________________________________________________
  645.  
  646. What's new in 1.6b7:
  647.  
  648. Bugs & Fixes
  649. =========
  650.  
  651. No bugs were fixed, because there were no bug reports yet.
  652.  
  653. NEW: One addition to the external files that were introduced
  654. with b6 is, that you can have two values per line. The format
  655. is now
  656.  
  657. value1<TAB>result
  658. value2<TAB>result
  659. value3<TAB>result
  660. ...
  661.  
  662. and if you use {#filename}, it will match any of the valueX
  663. values. If there is a <TAB>result string after the value, the
  664. corresponding <Xn> tag will not be the value but instead it
  665. will be the "result". This will give you the ability to define
  666. data pairs like name-password and a resulting string.
  667. Example:
  668.  
  669. Path: /myDirectory*
  670. Authorization: {#mypasswords}
  671. Condition: <P0>&<!C0>
  672. Path Result: <C1>
  673. Redirect: checked
  674.  
  675. and the file "#mypasswords will be:
  676. andreas:pardeike   <TAB>   http://www.somehost.com
  677. james:dean   <TAB>   http://www.apple.com
  678. ...
  679.  
  680. NEW: The statistics can now be called separately for each
  681. virtual host. Before, you could only call stats.welcome?n
  682. (or pi_admin_stats.welcome?n for private access) with
  683. n = 1..6.
  684. Now you can use stats.welcome?n/virtual_host
  685. with n=1...6 (jpeg quality) and
  686. virtual_host = e.g. www.somehost.com
  687. to show only the stats for www.somehost.com
  688.  
  689. NEW: There is an additional password you can configure
  690. for each virtual host. If you set the stats to private, your
  691. users can access their very own stats through:
  692. ..../stats.welcome?n/www.theirdomain.com    (n=1...6)
  693. Welcome protects this url with the configured password.
  694. The password is entered like this: username:password
  695. Of course, the full stats can only accessed through:
  696. ..../pi_admin_stats.welcome?n    (n=1...6)
  697. which only the webmaster knows the password.
  698.  
  699. ____________________________________________________________
  700.  
  701. What's new in 1.6b6:
  702.  
  703. Bugs & Fixes
  704. =========
  705.  
  706. No bugs were fixed, because there were no bug reports yet.
  707.  
  708. NEW: Now you can use {#filename} instead of
  709. {valueA valueB valueC...}. There must be a file called
  710. "#filename" inside the "Welcome-Plugin ƒ" folder. The
  711. values in this file are separated by returns (like a one-field
  712. export from FileMaker) and there is no limit to these values
  713. but just the amount of free memory in your server application.
  714. A good example is a check for robots. Assuming that you have
  715. compiled a text file "#myrobotslist" you can write:
  716. Browser: "*{#myrobotlist}*", which checks for many
  717. text fragments in the browser type string. You can easily
  718. update the values by editing the text file.
  719. Note: the text files are checked while starting Welcome. You
  720. can reload all text files with ..../pi_admin.welcome?reload
  721.  
  722. NEW: Welcome can now send the Authorization message
  723. to get a new username/password combination from the
  724. browser. Just choose "Authorization" at "Mode" on your
  725. edit rule page. Then enter a realm name into the
  726. Rule Result, like Rule Result: "MYREALM". If the Execute
  727. Condition is true, Welcome will send a
  728. "HTTP/1.0 401 Unauthorized" message when this rule is
  729. executed. Here is an example:
  730.  
  731. Rule "My custom realm"
  732. Path:              *private*
  733. Authorization:     {#mypasswords}
  734. Execute Condition: <P0>&<!C0>
  735. Rule Result:       MYREALM
  736. Mode:              (x) Authorization
  737.  
  738. Then create a file called "#mypasswords" and
  739. enter:
  740.  
  741. Andreas:apassword
  742. Peter:anotherpwd
  743. Frank:hi
  744. ...
  745.  
  746. ____________________________________________________________
  747.  
  748. What's new in 1.6b5:
  749.  
  750. Bugs & Fixes
  751. =========
  752.  
  753. A major bug was fixed that will crash QuidProQuo (and
  754. less likely but possible WebSTAR and others too).
  755. Some minor bugs and misfunctions on how [] works are
  756. now fixed.
  757.  
  758. NEW: You can combine * or | with [] or {} freely. An
  759. example: To select windows/unix browsers, you can
  760. now use "Browser: *{win NT unix dos}*" which previously
  761. was not possible.
  762.  
  763. NEW: There are three new custom tags to use in the custom
  764. field of each rule: "Authorization", "Client IP" and
  765. "Client Name". Typical values to match for are e.g.:
  766. Authorization: "username:password"
  767. Client IP: "128.0.0.5"
  768. Client Name: "host03.somedomain.org" (if not resolvable,
  769. then the IP number is used in this field)
  770.  
  771. NEW: You don't need to encode "-", "^" or " " if you don't
  772. use them inside [] or {} brackets anymore. E.g. you can
  773. now write Path: "*cgi-bin*" instead of "*cgi\-bin*"
  774. This is easier for beginners and not so restrictive.
  775.  
  776. ____________________________________________________________
  777.  
  778. What's new in 1.6b4 (1.6b3 was never released):
  779.  
  780. Bugs & Fixes
  781. ==========
  782.  
  783. All variables initialized to default values. That fixes bugs
  784. that appeared in QuidProQuo. Also fixed some really stupid
  785. typos. This version should not crash anymore with QPQ.
  786. Still to do: Support for *{}.
  787.  
  788. ____________________________________________________________
  789.  
  790. What's new in 1.6b2:
  791.  
  792. Bugs & Fixes
  793. =========
  794.  
  795. Several bugs and two memory leaks fixed. A bug in the main
  796. header parsing shows that even Welcome 1.5 or older will
  797. not handle requests like: 
  798. "GET /something.html<CR><LF><CR><LF>" correctly. This
  799. is now fixed.
  800. The Test-Page now correctly shows all extra values and
  801. the file checking process. There is still a need to send
  802. a full custom request to check ALL new features of Welcome.
  803.  
  804.  
  805. Relative Path for "Missing Host Field (prefs page)"
  806. =====================================
  807. Now you can use a root relative path for the old
  808. "Redirect instead of Missing Host Page" field at the prefs
  809. page. Welcome will substitute the current value of the
  810. incoming request path with this field. This enables you
  811. to put a path to a script into this field and write all
  812. information for the current request out to a file.
  813. Example for this field: "/cgi-bin/myscript.acgi"
  814.  
  815. ____________________________________________________________
  816.  
  817. What's new in 1.6b1:
  818.  
  819. Added extra tag field in Rules
  820. ==================
  821.  
  822. As the 6th field in Rules, you can enter your own tag name and
  823. use it to make decisions or built path results on it.
  824. You can access it by using the <Cn> reference, where n is as usual
  825. n = 0...9.
  826.  
  827. I have added the reference names at the end of each tag field so
  828. you can easily remember them.
  829.  
  830. Remember that you can put any name in the first field and you
  831. don't have to include the colon (:). Here is an example:
  832.  
  833. "Pragma"  :  "no-cache"
  834.  
  835. will check for the browser sending "Pragma: no-cache" with
  836. the request. Also a good example is to check for a password.
  837. If you don't know which tags are send by a browser, you can
  838. set WebSTAR to "Verbose Mode" and watch the log window.
  839.  
  840. This field is also very useful for checking a tag twice. E.g.
  841. you could enter "Host" and have two lines for host checking.
  842.  
  843. FUTURE ENHANCEMENTS:
  844. Currently, this field only support the real tags from the
  845. request header. But I will add some more names that will
  846. rely on:
  847. - IP number or name of requestor
  848. - decoded username/password
  849. - date and time
  850. If you can think of others, please mail me your suggestions
  851.  
  852.  
  853. Added check for file existance
  854. ==================
  855.  
  856. The second improvement is a file check. For this, you can
  857. use the two fields after the tag field section.
  858.  
  859. The first field is a condition field and it will allow you to
  860. only check a file path if there is a need for it. This will save
  861. cpu time. It is basically the same as the normal condition
  862. field in the action section (that one that will control the
  863. rule execution) and you can put strings like <H0>&<!P1>
  864. into it.
  865.  
  866. The second field is a relative url path that is to be checked.
  867. It need to start with a "/" and then should point to a file
  868. that you like to check. This path is checked from the servers
  869. root. You can (and should) use the tag references in this field
  870. and it is good to keep in mind that it almost works like the
  871. path result field. Here's an example:
  872.  
  873. File Path to check:      "/subfolder/<P1>.lasso"
  874.  
  875. Welcome will ignore any $ or ? arguments and will only
  876. check the real path portion of this field. Please note that
  877. you cannot start this field with "http://server", it need
  878. to be a RELATIVE path.
  879.  
  880. Finally, you can refer for the check (in the execute condition)
  881. by using the reference "<FC>" (File Check) and it will result
  882. in TRUE or FALSE depending on the existance of the checked
  883. path.